{% extends "howto" %}

{% block main %}
<h2 id="loading-a-kit">Charger un Kit de librairie</h2>
<p>L'archive de webappkit devrait être décompressée à la racine de votre site.
Avant d'inclure un kit, placez la ligne suivant dans votre code (une seule fois par execution) :</p>

<code>// inclusion des librairies de base de webappkit
include('webappkit/include-me.php');</code>

<p>Lorsque vous avez besoin d'un kit de librairie, par exemple <q>example</q>,
<strong>chargez le</strong> avec :</p>

<code>// chargement des librairies du kit "example"
webappkit::loadKit('example');</code>

<p>Webappkit autorise l'imbrication de kits et utilise une syntaxe pointée pour accéder aux kits imbriqués. Si vous avez seulement besoin d'une partie du kit (<em>subkit</em>), par exemple <em>hello</em> au sein de <em>example</em>, chargez la avec :</p>

<code>// chargement des librairies du sous-kit "hello" du kit "example"
webappkit::loadKit('example.hello');</code>

<p>Dans cet exemple, <q>example.hello</q> requiert <q>example.base</q>.
Mais vous n'avez pas à vous en soucier, grâce à la gestion interne des dépendances.</p>

<h3>Le mécanisme</h3>

<p>Lorsque vous chargez un kit, webappkit va chercher dans le repertoire des kits (généralement <q>webappkit/</q>) un dossier du même nom terminé par <q>.wak</q>,
et lire dans ce dossier un fichier nommé <q>wak.ini</q>. Ce fichier liste les dépendances du kit, qui seront incluses, puis les fichiers du kit à charger.
</p>

<p>Si vous ciblez un sous-kit, webappkit va parcourir l'arborescence physique des kits jusqu'à trouver le kit ciblé. Par exemple, <q>example.hello.world</q> fait référence au dossier de kit <q>example.wak/hello.wak/world.wak/</q>.</p>
{% endblock %}
